.. _ecdiLtc_DelChannel:

ecdiLtc_DelChannel
==================
------------------

SYNOPSYS
`````````````
.. code-block:: none

  t_success ecdiLtc_DelChannel (
    t_i32 NetID, 
    t_ui32 DiChannel, 
    t_i32 *ErrCode)

  t_success ecdiLtc_DelChannel_L (
    t_i32 NetID, 
    t_ui16 SlvPhysAddr, 
    t_i32 LocalChannel, 
    t_i32 *ErrCode)

DESCRIPTION
`````````````  
- 래치(Latch) 모드로 등록된 디지털입력 채널을 감시 대상 리스트에서 제거합니다.

PARAMETER
`````````````

- NetID : Network 번호

- DiChannel : 디지털 입력 채널 번호

- SlvPhysAddr: 슬레이브 주소

- LocalChannel : 해당 디지털 입력 채널의 지역 채널 번호

- ErrCode : 이 매개 변수를 통하여 현재의 에러 코드를 반환합니다. 단, 이 매개 변수에 NULL을 전달하면 에러 코드를 반환하지 않습니다.


RETURN VALUE
`````````````
- 함수 수행의 성공 여부를 반환합니다.

+-------+--------------------------------------+
| Value | Meaning                              |
+=======+======================================+
| 0     | 함수 수행에 실패하였음을 의미합니다. |
+-------+--------------------------------------+
| 1     | 함수 수행에 성공하였음을 의미합니다. |
+-------+--------------------------------------+


EXAMPLE
`````````````

.. code-block:: cpp
 :linenos:

 #define NETID  0
 #define LTC_CH 0

 // OnStartLatchMon(): 래치모니터를 시작하는 가상의 사용자 함수 
 void OnStartLatchMon()
 {
	t_i32 errCode;
	if(!ecdiLtc_AddChannel(NETID, LTC_CH, &errCode)){
	// 에러처리
	}
 }
 
 // OnTimer (): 래치 상태를 주기적으로 체크하는 가상의 사용자 함수 
 void OnTimer()
 {
	if(ecdiLtc_GetOnCount(NETID, LTC_CH, true, NULL) > 0){
	// 래치 발생함!
	//…
	}
 }
 
 // OnProgramExit (): 프로그램의 종료 시에 호출되는 가상의 사용자 함수 
 void OnProgramExit()
 {
	ecdiLtc_DelChannel(NETID, LTC_CH, NULL)
 }

.. note::
  ecdiLtc_DelChannel 함수를 실행하지 않아도 사용자 프로그램이 종료될 때에 해당 프로그램에서 등록한 래치 채널들은 자동으로 리스트에서 삭제됩니다. 따라서 이 함수의 실행을 생략해도 무방합니다.

.. seealso::
   :ref:`ecdiLtc_AddChannel`